home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / graphics / fractk17.zip / FRACTK17.DOC < prev   
Text File  |  1993-01-14  |  8KB  |  205 lines
  1.                                                                 -1-
  2.  
  3.  
  4.  
  5.                                    FRACT_KL
  6.  
  7.          DESCRIPTION:
  8.  
  9.          Fract_kl is a "screen idle" program based on fractal sets.
  10.          Simply type "Fract_kl" and the default settings will create
  11.          paisley-like patterns created from fractal algorithms.  The
  12.          default setting creates Julia sets with random windows and
  13.          random selection of palette.
  14.  
  15.          VGA (MODE 13H) ONLY!!!
  16.  
  17.          Press escape to exit.
  18.  
  19.          OPTIONS "On the fly":
  20.  
  21.          Many options can be accessed without stopping the display
  22.          simply by typing a letter (WITHOUT <enter>).
  23.  
  24.          + or - will change the delay setting to speed up or slow down
  25.          the program.
  26.  
  27.          P{n} will select palette number n, where n=0 to 9.
  28.  
  29.          P{x} will select palettes from 10 to 71 when x='A' to '~'
  30.          based on ascii value of x-55.  If n is not specified,
  31.          the palette options menu will appear.  Note: palettes 72
  32.          through 89 can only be accessed through the palette options
  33.          menu.
  34.  
  35.          Pressing 1-9 will set the minimum colorstep.
  36.  
  37.          'S' will save the image to disk when completed or when
  38.          paused. Images will be saved as FRACTKnn.BLD & FRACTKnn.PLT
  39.          to the default drive and directory (will start @ nn=0).
  40.  
  41.          'M' will select Mandelbrot based images.
  42.  
  43.          'J' will select Julia based images.
  44.  
  45.          'W' toggles a wraparound filter on/off.  An integer algorithm
  46.          is used to calculate the pixels.  Overflow conditions will
  47.          produce artifactual detail in normally "quiet" zones of the
  48.          images.  When the filter is in place (default is ON), this
  49.          noise is suppressed and true fractal images are produced.
  50.  
  51.          <space> will pause the image when completed.  Once paused,
  52.          typing 'R' will rotate palette (+ & - now control the
  53.          direction of rotation).  Image can be saved while paused.
  54.          Press <esc> to exit pause mode.
  55.  
  56.          'A' will toggle the random palette change- new palette for
  57.          each new image.
  58.  
  59.          <esc> exits the current function or program.
  60.                                                                 -2-
  61.          OPTIONS MENUS:
  62.  
  63.          'C' will bring up the color options menu where the minimum
  64.          and maximum step values can be changed.  Step values are
  65.          determined by minimumstep + random(maximumstep).
  66.  
  67.          'P' (alone) will bring up the Palette options menu.
  68.  
  69.          'H' or 'F1' will call the Help! screen.
  70.  
  71.          'I' will allow changing of the value for maximum iterations.
  72.          The higher the value, the more detail, but less speed.
  73.  
  74.  
  75.          GLOBAL OPTIONS MENU:
  76.  
  77.          Any character not listed above will bring up the global
  78.          options menu where all parameters can be altered.
  79.  
  80.          My default values are listed for informational purposes.
  81.          Enter a new value or just press <enter> and the value will
  82.          stay at your preset level.
  83.  
  84.          The lower limit of the real and imaginary windows for the
  85.          fractal calculation may be set.  The actual lower limit will
  86.          be randomly selected as a value equal to or greater than this
  87.          lower limit.
  88.  
  89.          The MAXimum and MINimum STEP for real and imaginary windows
  90.          may also be set.  The actual width of the window will be a
  91.          random value between MAXSTEP and zero plus MINSTEP.
  92.  
  93.          The maximum and minimum color steps are selected such that
  94.          the step between adjacent colors is random(maximum) +
  95.          minimum.
  96.  
  97.          Ninety palette options, including a random palette which
  98.          changes each time selected, are included.  The Eightcolor
  99.          palette is most interesting if a minimum color step of one is
  100.          used.  Most palettes are unnamed.
  101.  
  102.          The Wraparound filter can be enabled or disabled.
  103.  
  104.          Automatic palette change can be enabled or disabled.
  105.  
  106.          Maximum iterations are next.  More iterations will increase
  107.          the detail, but slow program.
  108.  
  109.          Next is the delay factor.  The timing routine automatically
  110.          selects a value based on the speed of your machine, but other
  111.          values may be entered either here of by pressing + (faster)
  112.          or - (slower) while in the image screen.  If it is still to
  113.          slow, decrease the iteration value in this menu or by using
  114.          the 'I' command while in the image screen.
  115.  
  116.          Finally select between Julia or Mandelbrot based images.
  117.  
  118.  
  119.  
  120.                                                                 -3-
  121.  
  122.  
  123.          COMMAND LINE OPTIONS:
  124.  
  125.          FRACT_KL <S>nnn, where S is a switch listed below, entered in
  126.          any order.
  127.  
  128.          Dnnnnn: Set Delay factor where nnnnn= delay constant desired.
  129.                     (overrides the automatic timer selection).
  130.  
  131.          Innn: Set maximum number of Iterations.
  132.  
  133.          Pnn: Set Palette number.  Specifying a palette will
  134.               also turn off the automatic palette change feature.
  135.  
  136.          Wn: Set Wraparound filter: 0 off, 1 on.
  137.                    (default is off);
  138.  
  139.          Nn: Set miNimum colorstep.
  140.  
  141.          Xn: Set maXimum colorstep.
  142.  
  143.          J:  Julia based images (Julia is default).
  144.  
  145.          A-:  Turn off automatic palette change.
  146.  
  147.                                                                 -4-
  148.          BRIEF DISCUSSION:
  149.  
  150.          The images are generated from a fractal algorithm using
  151.          integer math.  While experimenting with different integer
  152.          subroutines I found that a "wraparound" effect occurred at
  153.          certain settings which added detail to otherwise boring
  154.          fringe areas of the fractal sets.  While the effect can be
  155.          useful for a random program such as this, I have added a
  156.          filter toggle to create true fractal images.
  157.  
  158.          While I do not have the patience to type an in depth
  159.          discussion of fractal geometry, I offer a brief description
  160.          for those not familiar with the basics.
  161.  
  162.          The Fractal images are generated from the behavior of a given
  163.          value when subjected to the general formula:
  164.  
  165.              X(k+1) = fn(X(k)) + c
  166.  
  167.          The value of X will tend to go to infinity or a finite
  168.          attractor (such as zero in this program).  The function used
  169.          for this program (and most fractal programs) is X*X.  When
  170.          the function exceeds an arbitrary bailout value, it is
  171.          assumed it is headed for infinity and the starting point is
  172.          assigned the value k (the number of iterations).  X is a
  173.          complex number (X = a + bi).
  174.  
  175.          Mandelbrot sets are created starting with x = 0 and plotting
  176.          the behavior as the constant c is varied.
  177.  
  178.          Julia sets are calculated using a preselected value for c and
  179.          plotting the behavior as the starting a and b components of X
  180.          are varied.
  181.  
  182.          In my program, the calculations are made only for one
  183.          quadrant of the screen and mirrored to the other three
  184.          quadrants for a kaleidoscopic effect.  Julia sets are
  185.          selected at random along six lines "drawn" on a Mandelbrot
  186.          set.  The real and imaginary boundaries for the Julia sets
  187.          are randomly selected.
  188.  
  189.          VER 1.7: Fixed "breakout" bug that caused unexpected exits
  190.          on some systems.
  191.  
  192.          CREDITS:
  193.  
  194.          The program was created using Turbo Pascal 5.0 mixed with
  195.          assembly code.  The program was inspired by the (incredible)
  196.          FRACTINT program from which some of the palettes have been
  197.          lifted.
  198.  
  199.          Enjoy.
  200.  
  201.          Richard E. Barlow
  202.          122 Pebble Beach Dr.
  203.          Slidell, LA 70458
  204.          (504) 641-9549
  205.